home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr28 / netbday2.zip / NETBDAY.DOC next >
Text File  |  1993-03-01  |  6KB  |  151 lines
  1.                               NetBday
  2.  
  3.                     A very silly netware utility.
  4.  
  5. "This is probably the stupidest programme my son (the doctor) has ever 
  6. written" (authentic apocryphal misquote from the author's mother)
  7.  
  8.  
  9. 1) Licencing and legal stuff
  10.  
  11. This software and associated documentation is copyright software and 
  12. may only be distributed and used under the terms described herein. The 
  13. documentation and software provided in this package may be freely 
  14. copied and distributed in unaltered form only. No fee may be charged 
  15. for distribution or use of this package except by prior arrangement 
  16. with the copyright holder whose contact details are provided at the 
  17. end of this text. 
  18.  
  19. This software and documentation are guaranteed to take up room on your 
  20. disk until they are deleted. In addition, if this software breaks 
  21. anything of yours, you get to keep all the pieces. Other than that, 
  22. there are no guarantees or warranties of any kind including 
  23. merchantability or fitness for purpose provided with this package. Use 
  24. it at your own peril. Remember, you usually get what you pay for.
  25.  
  26. If you install this package, you may use it for a trial period of up 
  27. to one calendar month with no obligation. If you like the package and 
  28. wish to continue using it, you must send the author a postcard or 
  29. email (details below) preferably describing the setting and number of 
  30. users on your network(s). Other than that, go for it.
  31.  
  32. This package is released in the spirit of David Harris's Pegasus email 
  33. package for netware. If you haven't yet got it, get it from 
  34. splicer.cba.hawaii.edu - it beats most other netware email packages 
  35. hands down. Don't blame Dave Harris for my package.
  36.  
  37. 2) Description
  38.  
  39. NetBday is a network login utility (specific to Novell networks) which 
  40. is extremely popular with the users on my network (they made me write 
  41. it when a clinical package I wrote started playing happy birthday 
  42. whenever it was the birthday of a patient whose records were being 
  43. accessed). It is quintessentially silly. This stupid program announces 
  44. your user's birthdays to the world by playing "Happy Birthday" 
  45. (complete with words for those who don't know them) whenever they 
  46. login. Amazingly enough, that's all it does !.
  47.  
  48. 3) Installation
  49.  
  50. Create a text file (details below) containing your network's user 
  51. login names, the text you want displayed as the users name (for 
  52. example, a full name or nickname) and their birthdate. Call it 
  53. BDLIST.DAT (or whatever you prefer). Put both the netbday.exe file and 
  54. the birthday list file in your sys:public directory (or some other 
  55. directory available to all users during the execution of the system 
  56. login script. Make BOTH files readonly and sharable (use the netware 
  57. "flag" utility - eg - "flag netbday.exe ro s") and add the following 
  58. lines somewhere near the end of your system login script :-
  59.  
  60. #sys:public/netbday /public/bdlist.dat [U|a|n]
  61.  
  62. The first parameter on this login script command line is REQUIRED ! It must
  63. be a file containing birthday dates and user names (see below) and the
  64. user MUST HAVE READ and FIND ACCESS TO THAT DIRECTORY !!. SYS:PUBLIC is a
  65. reasonable place for such a file.
  66.  
  67. The optional 2nd parameter a or n or u controls the behaviour of the 
  68. program. The default is U.
  69. For music to be played to ALL users on any other user's birthday use a.
  70. For music NEVER to be played use n.
  71. For music to be played ONLY when a user logs in on his/her birthday, use u.
  72.  
  73. To recapitulate, the optional second parameter controls whether happy 
  74. birthday is played to All users, (ie whenever it's someones birthday), 
  75. No users (not even the user whose birthday it is) or the user (when it's 
  76. his/her birthday) only.
  77.  
  78. The first parameter is the name of a birthday file - eg
  79.  
  80. netbday \public\bdlist.dat a
  81.  
  82. where the file, a plain ASCII text file, contains lines like 
  83.  
  84. Joe 22/11/1982
  85. june 10/03/1923
  86. etc
  87.  
  88. Comments lines have * as the first character and are ignored
  89.  
  90.  
  91. When a user logs in, the netbday executable reads the birthday list 
  92. file (the path is passed as a command line parameter as shown above). 
  93. It looks to see if anyone has a birthday today, and if so, plays
  94. "happy birthday" depending on the second parameter. 
  95.  
  96. If not, it clears the screen, prints the programme name and version 
  97. followed by a line saying whose birthday is next and in how many days if
  98. less than 6. During the playing of "happy birthday", pressing any 
  99. key will stop the silliness. 
  100.  
  101. Note that some users may be insulted by this bizarre piece of social 
  102. engineering, in which case the following strategem is recommended. 
  103. Create a new user group (called BD for example). Make all users who 
  104. want this program executed during login members of this group. Then 
  105. change the system login script to something like this :-
  106.  
  107. if member of "BD" then begin
  108. #sys:public/netbday /public/bdlist.dat
  109. end
  110.  
  111. 4) Birthday list file structure 
  112.  
  113. The BDLIST.DAT file must be a plain ascii file (NOT a nerdperfect file 
  114. for example - although you can ask most wordprocessors to make a plain 
  115. dos text file). Each line starting with an asterix (*) is ignored as a 
  116. comment. Lines of data must have a netware user name, a comma, a
  117. name to display for that user name, another comma and a birthdate as 
  118. dd/mm (eg 03/06 for the third of June) for example :-
  119.  
  120. * this comment line will not be used as data
  121. jim,Sir James PonceNeuf,03/02
  122. judy,Judy Surname,04/05
  123. * this is the end of the file
  124.  
  125.  
  126. 5) Contacting the Author 
  127.  
  128. NetBday was written in Turbo Pascal and uses a call from the tp5_api 
  129. unit of Mark Bramwell (mark@hamster.business.uwo.ca) for finding the 
  130. user's name. It uses the music unit of JC Kessels (J.C. Kessels,Philips de 
  131. Goedelaan 7, 5615 PN Eindhoven,Netherlands).
  132.  
  133. Source code will be made available for large amounts of money or other 
  134. good reason. 
  135.  
  136. Email may be sent via the Internet to :-
  137. rml@extro.ucc.su.OZ.AU 
  138.  
  139. Postcards may be sent to :-
  140. Dr. Ross Lazarus
  141. 29 Francis St.
  142. Bondi  NSW 2026
  143. Australia.
  144.  
  145. Please provide details of the equipment in use and problem(s) 
  146. encountered if 'misfeatures' are detected in using this software, to the 
  147. above address.
  148.  
  149. rml
  150. July 4, 1991.
  151.